home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / readcpm.zip / READCPM.DOC < prev   
Text File  |  1987-06-13  |  5KB  |  125 lines
  1.               Documentation file for READCPM.COM
  2.  
  3. Purpose:
  4.  
  5.      READCPM provides the capacity to read CP/M double density soft-sectored
  6. diskettes from the Heath-Zenith CP/M 2.20X versions written on an H89-90 or
  7. with CP/M-85 on the Z-100, and transfer these files to MSDOS files on a
  8. Z-150 or ROM BIOS compatible  8086-8 machine.
  9.  
  10. Hardware requirements:
  11.  
  12.    a) A IBM PC compatible computer with at least one 5" double sided
  13.       drive and one other drive ( hard disk or memory disk will work ).
  14.  
  15.    b) MSDOS 2.x or PCDOS 2.x or higher.
  16.  
  17.    c) Sufficent memory ( say 256K ).
  18.  
  19. User Interface:
  20.  
  21.       The method of tagging files is modeled on the DISK7X series
  22. of transfer programs for CP/M computers.  Only copying and viewing
  23. functions are implemented. No writing or deleting of CP/M files is
  24. implemented. The error checking is minimal. If a non-existent target
  25. is specified, a separate error is reported for each tagged file.
  26.  
  27. Detailed description of commands:
  28.  
  29. T - tags the file for inclusion in the mass copy
  30.  
  31. U - untags a previously tagged file from inclusion in the mass copy
  32.  
  33. V - views a text file on the console screen. Caution - any file is
  34.     viewable. Typically, .COM and other binary files will result in
  35.     garbled screens. Press Cntrl-C to stop a display.
  36.  
  37. P - sends a file to the list device. Same caution as for V applies.
  38.     No tab expansion or paging is done.
  39.  
  40. W - do a mass tag or untag of files.
  41.  
  42. M - does a mass copy of all files tagged to the target directory
  43.     No checking for overwriting of files with the same name is performed.
  44.  
  45. B - move the pointer into the directory listing back one notch
  46.  
  47. ? - displays the help screen again
  48.  
  49. S - saves a copy of the current CP/M disk parameters (label) to a disk file.
  50.  
  51. G - reads from a disk file the default disk parameters to be used with the
  52.     next disk logged in
  53.  
  54. X - Z or Q. Return to DOS.
  55.  
  56. L - log in a new disk.
  57.  
  58. Bugs:
  59.  
  60.     The program may "hang" on disk errors and require rebooting the
  61. computer. Since the disk parameter tables are changed to permit reading
  62. other formats, an abnormal termination of the program may leave the
  63. parameters in a state which will not read MSDOS diskettes. Again, the
  64. solution is to reboot.
  65.  
  66. Limitations:
  67.  
  68.     a) 8" diskettes are not supported
  69.  
  70.     b) Single density and/or hard sectored diskettes are not supported.
  71.        Formats using logical skewing of sectors are not supported.
  72.        Physical skewing of sectors is supported.
  73.  
  74.     c) CP/M-86 diskettes formatted with the IBM PC distribution copy of
  75.        CP/M-86 are readable, but formats from other machines may not be.
  76.  
  77.     d) 96 tpi drives are supported only in that 96 tpi diskettes may be
  78.        read. 48 tpi diskettes are not readable on 96 tpi drives with this
  79.        software. Of course, 96 tpi diskettes are not readable with a 48 tpi
  80.        drive, although since often track 0 is readable, it may be logged in.
  81.  
  82.     e) The copying is done by CP/M allocation blocks of 1k or 2k. Hence some
  83.        text files may have excess " junk" at the end when viewed with some
  84.        MSDOS editors. Find a sequence of left arrows ( the screen
  85.        repesentation of acsii ^Z or hex 1A )  for the true end of file.
  86.  
  87.     f) Although some provision is made for accomodating non-Heath
  88.        formats, this requires a detailed understanding of the Heath track 0,
  89.        sector 1 system of disk labels. With this understanding, such a label
  90.        can be written to a disk to be logged, and then the actual disk used
  91.        subsequently. Alternatively, a ascii file containing the parameters can
  92.        be created. See the listing of the Heath 2.20X  BIOS for details about
  93.        the disk label.
  94.  
  95. Logging in of Heath-Zenith CP/M diskettes:
  96.  
  97.     Heath-Zenith diskettes formatted under CP/M 2.20X or CP/M-85
  98. with a "label" on track 0 sector 1 will be logged automatically.
  99. CP/M-86 single or double sided diskettes will be logged if formatted
  100. by the IBM PC version of CP/M-86.
  101.  
  102. Logging of other diskettes:
  103.  
  104.    If the label from track 0 sector 1 does not checksum correctly,
  105. the user is given the option of logging a similar disk, reading
  106. parameters from a file, or using the default parameters. The default
  107. parameters must be set using a "G" command. The file could be created
  108. with the "S" command, or by hand from an editor.
  109.  
  110.    Caution - use of the wrong parameters can result in garbled directory
  111. listings or garbled transferred files. The specification of a wrong sector
  112. size will result in a long delay and some bell sounds. Consult the CP/M
  113. bios listings and a reference such as "MASTERING CP/M" by Alan R. Miller
  114. (Sybex, 1983) for an explanation of the disk parameter tables.
  115.  
  116.    CP/M-86 diskettes are detected by 512 byte sectors and the appropriate
  117. bytes on bytes 0 and 511 of track 0 sector 1. If the sectors are 512 bytes
  118. but the test bytes are not correct, the user is allowed to specify SS or DS
  119. CP/M-86 format, or specify other defaults.
  120.  
  121.  
  122.               READCPM.DOC         page 2
  123.  
  124. * CP/M is a trademark of Digital Research Incorporated
  125.